/ Celestin Apprentice 4 / Apprentice-Release4.iso / Source Code / Add-Ons / MPW / MPW noweb 2.7 / src / xdoc / noweb.1

< prev

next >

MacOS 8.1

Win98

DOS

browse contents

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 2e 54 48 20 4e 4f 57 45 | 42 20 31 20 22 6c 6f 63 |.TH NOWE|B 1 "loc|
|00000010| 61 6c 20 34 2f 31 39 2f | 39 33 22 0d 2e 53 48 20 |al 4/19/|93"..SH |
|00000020| 4e 41 4d 45 0d 6e 6f 77 | 65 62 20 5c 2d 20 61 20 |NAME.now|eb \- a |
|00000030| 73 69 6d 70 6c 65 20 6c | 69 74 65 72 61 74 65 2d |simple l|iterate-|
|00000040| 70 72 6f 67 72 61 6d 6d | 69 6e 67 20 74 6f 6f 6c |programm|ing tool|
|00000050| 0d 2e 53 48 20 53 59 4e | 4f 50 53 49 53 0d 2e 42 |..SH SYN|OPSIS..B|
|00000060| 20 6e 6f 77 65 62 0d 5b | 5c 66 42 2d 74 5c 66 50 | noweb.[|\fB-t\fP|
|00000070| 5d 20 0d 5b 5c 66 42 2d | 6f 5c 66 50 5d 20 0d 5b |] .[\fB-|o\fP] .[|
|00000080| 5c 66 42 2d 4c 5c 66 50 | 5c 66 49 66 6f 72 6d 61 |\fB-L\fP|\fIforma|
|00000090| 74 5c 66 50 5d 20 0d 5b | 5c 66 42 2d 6d 61 72 6b |t\fP] .[|\fB-mark|
|000000a0| 75 70 5c 66 50 20 5c 66 | 49 70 61 72 73 65 72 5c |up\fP \f|Iparser\|
|000000b0| 66 50 5d 0d 5b 66 69 6c | 65 5d 20 2e 2e 2e 0d 2e |fP].[fil|e] .....|
|000000c0| 53 48 20 44 45 53 43 52 | 49 50 54 49 4f 4e 0d 2e |SH DESCR|IPTION..|
|000000d0| 49 20 4e 6f 77 65 62 0d | 69 73 20 61 20 6c 69 74 |I Noweb.|is a lit|
|000000e0| 65 72 61 74 65 2d 70 72 | 6f 67 72 61 6d 6d 69 6e |erate-pr|ogrammin|
|000000f0| 67 20 74 6f 6f 6c 20 6c | 69 6b 65 0d 2e 49 20 46 |g tool l|ike..I F|
|00000100| 75 6e 6e 65 6c 57 45 42 | 0d 6f 72 20 0d 2e 49 20 |unnelWEB|.or ..I |
|00000110| 6e 75 77 65 62 2c 0d 6f | 6e 6c 79 20 73 69 6d 70 |nuweb,.o|nly simp|
|00000120| 6c 65 72 2e 0d 41 20 0d | 2e 49 20 6e 6f 77 65 62 |ler..A .|.I noweb|
|00000130| 0d 66 69 6c 65 20 63 6f | 6e 74 61 69 6e 73 20 70 |.file co|ntains p|
|00000140| 72 6f 67 72 61 6d 20 73 | 6f 75 72 63 65 20 63 6f |rogram s|ource co|
|00000150| 64 65 20 69 6e 74 65 72 | 6c 65 61 76 65 64 20 77 |de inter|leaved w|
|00000160| 69 74 68 20 64 6f 63 75 | 6d 65 6e 74 61 74 69 6f |ith docu|mentatio|
|00000170| 6e 2e 0d 57 68 65 6e 20 | 0d 2e 49 20 6e 6f 77 65 |n..When |..I nowe|
|00000180| 62 0d 69 73 20 69 6e 76 | 6f 6b 65 64 2c 20 69 74 |b.is inv|oked, it|
|00000190| 20 77 72 69 74 65 73 20 | 74 68 65 20 70 72 6f 67 | writes |the prog|
|000001a0| 72 61 6d 20 73 6f 75 72 | 63 65 20 63 6f 64 65 20 |ram sour|ce code |
|000001b0| 0d 74 6f 20 74 68 65 20 | 6f 75 74 70 75 74 20 66 |.to the |output f|
|000001c0| 69 6c 65 73 20 6d 65 6e | 74 69 6f 6e 65 64 20 69 |iles men|tioned i|
|000001d0| 6e 20 74 68 65 20 6e 6f | 77 65 62 20 66 69 6c 65 |n the no|web file|
|000001e0| 2c 20 61 6e 64 20 69 74 | 20 77 72 69 74 65 73 20 |, and it| writes |
|000001f0| 61 20 0d 2e 49 20 54 65 | 58 0d 66 69 6c 65 20 66 |a ..I Te|X.file f|
|00000200| 6f 72 20 74 79 70 65 73 | 65 74 20 64 6f 63 75 6d |or types|et docum|
|00000210| 65 6e 74 61 74 69 6f 6e | 2e 0d 2e 50 50 0d 46 6f |entation|...PP.Fo|
|00000220| 72 20 6d 6f 72 65 20 66 | 6c 65 78 69 62 69 6c 69 |r more f|lexibili|
|00000230| 74 79 2c 20 63 6f 6e 73 | 69 64 65 72 0d 2e 49 20 |ty, cons|ider..I |
|00000240| 6e 6f 74 61 6e 67 6c 65 | 28 31 29 0d 61 6e 64 20 |notangle|(1).and |
|00000250| 0d 2e 49 20 6e 6f 77 65 | 61 76 65 28 31 29 2e 0d |..I nowe|ave(1)..|
|00000260| 2e 53 48 20 46 4f 52 4d | 41 54 20 4f 46 20 4e 4f |.SH FORM|AT OF NO|
|00000270| 57 45 42 20 46 49 4c 45 | 53 0d 41 20 0d 2e 49 20 |WEB FILE|S.A ..I |
|00000280| 6e 6f 77 65 62 20 0d 66 | 69 6c 65 20 69 73 20 61 |noweb .f|ile is a|
|00000290| 20 73 65 71 75 65 6e 63 | 65 20 6f 66 0d 2e 49 20 | sequenc|e of..I |
|000002a0| 63 68 75 6e 6b 73 2c 0d | 77 68 69 63 68 20 6d 61 |chunks,.|which ma|
|000002b0| 79 20 61 70 70 65 61 72 | 20 69 6e 20 61 6e 79 20 |y appear| in any |
|000002c0| 6f 72 64 65 72 2e 0d 41 | 20 63 68 75 6e 6b 20 6d |order..A| chunk m|
|000002d0| 61 79 20 63 6f 6e 74 61 | 69 6e 20 63 6f 64 65 20 |ay conta|in code |
|000002e0| 6f 72 20 64 6f 63 75 6d | 65 6e 74 61 74 69 6f 6e |or docum|entation|
|000002f0| 2e 0d 44 6f 63 75 6d 65 | 6e 74 61 74 69 6f 6e 20 |..Docume|ntation |
|00000300| 63 68 75 6e 6b 73 20 62 | 65 67 69 6e 20 77 69 74 |chunks b|egin wit|
|00000310| 68 20 61 20 6c 69 6e 65 | 20 74 68 61 74 20 73 74 |h a line| that st|
|00000320| 61 72 74 73 20 77 69 74 | 68 20 61 6e 20 61 74 20 |arts wit|h an at |
|00000330| 73 69 67 6e 20 28 40 29 | 20 0d 66 6f 6c 6c 6f 77 |sign (@)| .follow|
|00000340| 65 64 20 62 79 20 61 20 | 73 70 61 63 65 20 6f 72 |ed by a |space or|
|00000350| 20 6e 65 77 6c 69 6e 65 | 2e 0d 54 68 65 79 20 68 | newline|..They h|
|00000360| 61 76 65 20 6e 6f 20 6e | 61 6d 65 73 2e 0d 43 6f |ave no n|ames..Co|
|00000370| 64 65 20 63 68 75 6e 6b | 73 20 62 65 67 69 6e 20 |de chunk|s begin |
|00000380| 77 69 74 68 0d 2e 62 72 | 0d 3c 3c 5c 66 49 63 68 |with..br|.<<\fIch|
|00000390| 75 6e 6b 20 6e 61 6d 65 | 5c 66 50 3e 3e 3d 0d 2e |unk name|\fP>>=..|
|000003a0| 62 72 0d 6f 6e 20 61 20 | 6c 69 6e 65 20 62 79 20 |br.on a |line by |
|000003b0| 69 74 73 65 6c 66 2e 0d | 54 68 65 20 64 6f 75 62 |itself..|The doub|
|000003c0| 6c 65 20 6c 65 66 74 20 | 61 6e 67 6c 65 20 62 72 |le left |angle br|
|000003d0| 61 63 6b 65 74 20 28 3c | 3c 29 20 6d 75 73 74 20 |acket (<|<) must |
|000003e0| 62 65 20 69 6e 20 74 68 | 65 20 66 69 72 73 74 20 |be in th|e first |
|000003f0| 63 6f 6c 75 6d 6e 2e 0d | 43 68 75 6e 6b 73 20 61 |column..|Chunks a|
|00000400| 72 65 20 74 65 72 6d 69 | 6e 61 74 65 64 20 62 79 |re termi|nated by|
|00000410| 20 74 68 65 20 62 65 67 | 69 6e 6e 69 6e 67 20 6f | the beg|inning o|
|00000420| 66 20 61 6e 6f 74 68 65 | 72 20 63 68 75 6e 6b 2c |f anothe|r chunk,|
|00000430| 20 6f 72 20 62 79 20 65 | 6e 64 20 6f 66 20 66 69 | or by e|nd of fi|
|00000440| 6c 65 2e 0d 49 66 20 74 | 68 65 20 66 69 72 73 74 |le..If t|he first|
|00000450| 20 6c 69 6e 65 20 69 6e | 20 74 68 65 20 66 69 6c | line in| the fil|
|00000460| 65 20 64 6f 65 73 20 6e | 6f 74 20 6d 61 72 6b 20 |e does n|ot mark |
|00000470| 74 68 65 20 62 65 67 69 | 6e 6e 69 6e 67 20 6f 66 |the begi|nning of|
|00000480| 20 61 0d 63 68 75 6e 6b | 2c 20 69 74 20 69 73 20 | a.chunk|, it is |
|00000490| 61 73 73 75 6d 65 64 20 | 74 6f 20 62 65 20 74 68 |assumed |to be th|
|000004a0| 65 20 66 69 72 73 74 20 | 6c 69 6e 65 20 6f 66 20 |e first |line of |
|000004b0| 61 20 64 6f 63 75 6d 65 | 6e 74 61 74 69 6f 6e 20 |a docume|ntation |
|000004c0| 63 68 75 6e 6b 2e 0d 2e | 50 50 0d 44 6f 63 75 6d |chunk...|PP.Docum|
|000004d0| 65 6e 74 61 74 69 6f 6e | 20 63 68 75 6e 6b 73 20 |entation| chunks |
|000004e0| 63 6f 6e 74 61 69 6e 20 | 74 65 78 74 20 74 68 61 |contain |text tha|
|000004f0| 74 20 69 73 20 63 6f 70 | 69 65 64 20 76 65 72 62 |t is cop|ied verb|
|00000500| 61 74 69 6d 20 74 6f 20 | 74 68 65 0d 2e 49 20 54 |atim to |the..I T|
|00000510| 65 58 0d 66 69 6c 65 20 | 28 65 78 63 65 70 74 20 |eX.file |(except |
|00000520| 66 6f 72 20 71 75 6f 74 | 65 64 20 63 6f 64 65 29 |for quot|ed code)|
|00000530| 2e 0d 2e 49 20 6e 6f 77 | 65 62 0d 77 6f 72 6b 73 |...I now|eb.works|
|00000540| 20 77 69 74 68 20 5c 66 | 49 4c 61 54 65 58 5c 66 | with \f|ILaTeX\f|
|00000550| 50 3b 20 74 68 65 20 66 | 69 72 73 74 20 64 6f 63 |P; the f|irst doc|
|00000560| 75 6d 65 6e 74 61 74 69 | 6f 6e 20 63 68 75 6e 6b |umentati|on chunk|
|00000570| 20 6d 75 73 74 20 63 6f | 6e 74 61 69 6e 0d 61 20 | must co|ntain.a |
|00000580| 0d 2e 49 20 4c 61 54 65 | 58 0d 2e 42 20 22 5c 5c |..I LaTe|X..B "\\|
|00000590| 5c 5c 64 6f 63 75 6d 65 | 6e 74 73 74 79 6c 65 22 |\\docume|ntstyle"|
|000005a0| 0d 63 6f 6d 6d 61 6e 64 | 20 77 69 74 68 20 74 68 |.command| with th|
|000005b0| 65 20 0d 2e 42 20 6e 6f | 77 65 62 0d 64 6f 63 75 |e ..B no|web.docu|
|000005c0| 6d 65 6e 74 2d 73 74 79 | 6c 65 20 6f 70 74 69 6f |ment-sty|le optio|
|000005d0| 6e 2e 0d 49 74 20 6d 75 | 73 74 20 61 6c 73 6f 20 |n..It mu|st also |
|000005e0| 63 6f 6e 74 61 69 6e 20 | 61 20 0d 2e 49 20 4c 61 |contain |a ..I La|
|000005f0| 54 65 58 0d 2e 42 20 22 | 5c 5c 5c 5c 62 65 67 69 |TeX..B "|\\\\begi|
|00000600| 6e 7b 64 6f 63 75 6d 65 | 6e 74 7d 22 0d 63 6f 6d |n{docume|nt}".com|
|00000610| 6d 61 6e 64 2e 0d 2e 50 | 50 0d 43 6f 64 65 20 63 |mand...P|P.Code c|
|00000620| 68 75 6e 6b 73 20 63 6f | 6e 74 61 69 6e 20 70 72 |hunks co|ntain pr|
|00000630| 6f 67 72 61 6d 20 73 6f | 75 72 63 65 20 63 6f 64 |ogram so|urce cod|
|00000640| 65 20 61 6e 64 20 72 65 | 66 65 72 65 6e 63 65 73 |e and re|ferences|
|00000650| 20 74 6f 20 6f 74 68 65 | 72 20 63 6f 64 65 0d 63 | to othe|r code.c|
|00000660| 68 75 6e 6b 73 2e 0d 53 | 65 76 65 72 61 6c 20 63 |hunks..S|everal c|
|00000670| 6f 64 65 20 63 68 75 6e | 6b 73 20 6d 61 79 20 68 |ode chun|ks may h|
|00000680| 61 76 65 20 74 68 65 20 | 73 61 6d 65 20 6e 61 6d |ave the |same nam|
|00000690| 65 3b 0d 2e 49 20 6e 6f | 77 65 62 0d 63 6f 6e 63 |e;..I no|web.conc|
|000006a0| 61 74 65 6e 61 74 65 73 | 20 74 68 65 69 72 20 64 |atenates| their d|
|000006b0| 65 66 69 6e 69 74 69 6f | 6e 73 20 74 6f 20 70 72 |efinitio|ns to pr|
|000006c0| 6f 64 75 63 65 20 61 20 | 73 69 6e 67 6c 65 20 63 |oduce a |single c|
|000006d0| 68 75 6e 6b 2c 20 6a 75 | 73 74 20 61 73 0d 6f 74 |hunk, ju|st as.ot|
|000006e0| 68 65 72 20 6c 69 74 65 | 72 61 74 65 2d 70 72 6f |her lite|rate-pro|
|000006f0| 67 72 61 6d 6d 69 6e 67 | 20 74 6f 6f 6c 73 20 64 |gramming| tools d|
|00000700| 6f 2e 0d 2e 49 20 6e 6f | 77 65 62 0d 6c 6f 6f 6b |o...I no|web.look|
|00000710| 73 20 66 6f 72 20 63 68 | 75 6e 6b 73 20 74 68 61 |s for ch|unks tha|
|00000720| 74 20 61 72 65 20 64 65 | 66 69 6e 65 64 20 62 75 |t are de|fined bu|
|00000730| 74 20 6e 6f 74 20 75 73 | 65 64 20 69 6e 20 74 68 |t not us|ed in th|
|00000740| 65 20 73 6f 75 72 63 65 | 20 66 69 6c 65 2e 0d 49 |e source| file..I|
|00000750| 66 20 74 68 65 20 6e 61 | 6d 65 20 6f 66 20 73 75 |f the na|me of su|
|00000760| 63 68 20 61 20 63 68 75 | 6e 6b 20 63 6f 6e 74 61 |ch a chu|nk conta|
|00000770| 69 6e 73 20 6e 6f 20 73 | 70 61 63 65 73 2c 20 74 |ins no s|paces, t|
|00000780| 68 65 20 63 68 75 6e 6b | 20 69 73 0d 61 6e 20 60 |he chunk| is.an `|
|00000790| 60 6f 75 74 70 75 74 20 | 66 69 6c 65 3b 27 27 0d |`output |file;''.|
|000007a0| 2e 49 20 6e 6f 77 65 62 | 0d 65 78 70 61 6e 64 73 |.I noweb|.expands|
|000007b0| 20 69 74 20 61 6e 64 20 | 77 72 69 74 65 73 20 74 | it and |writes t|
|000007c0| 68 65 20 72 65 73 75 6c | 74 20 6f 6e 74 6f 20 74 |he resul|t onto t|
|000007d0| 68 65 20 66 69 6c 65 20 | 6f 66 20 74 68 65 20 73 |he file |of the s|
|000007e0| 61 6d 65 20 6e 61 6d 65 | 2e 0d 41 20 63 6f 64 65 |ame name|..A code|
|000007f0| 2d 63 68 75 6e 6b 20 64 | 65 66 69 6e 69 74 69 6f |-chunk d|efinitio|
|00000800| 6e 20 69 73 20 6c 69 6b | 65 20 61 20 6d 61 63 72 |n is lik|e a macr|
|00000810| 6f 20 64 65 66 69 6e 69 | 74 69 6f 6e 3b 0d 69 74 |o defini|tion;.it|
|00000820| 20 63 6f 6e 74 61 69 6e | 73 20 72 65 66 65 72 65 | contain|s refere|
|00000830| 6e 63 65 73 20 74 6f 20 | 6f 74 68 65 72 20 63 68 |nces to |other ch|
|00000840| 75 6e 6b 73 2c 20 77 68 | 69 63 68 20 61 72 65 20 |unks, wh|ich are |
|00000850| 0d 74 68 65 6d 73 65 6c | 76 65 73 20 65 78 70 61 |.themsel|ves expa|
|00000860| 6e 64 65 64 2c 20 61 6e | 64 20 73 6f 20 6f 6e 2e |nded, an|d so on.|
|00000870| 0d 5c 66 49 6e 6f 77 65 | 62 5c 66 50 27 73 20 6f |.\fInowe|b\fP's o|
|00000880| 75 74 70 75 74 20 69 73 | 20 72 65 61 64 61 62 6c |utput is| readabl|
|00000890| 65 3b 20 69 74 20 70 72 | 65 73 65 72 76 65 73 20 |e; it pr|eserves |
|000008a0| 74 68 65 20 69 6e 64 65 | 6e 74 61 74 69 6f 6e 20 |the inde|ntation |
|000008b0| 6f 66 20 65 78 70 61 6e | 64 65 64 0d 63 68 75 6e |of expan|ded.chun|
|000008c0| 6b 73 20 77 69 74 68 20 | 72 65 73 70 65 63 74 20 |ks with |respect |
|000008d0| 74 6f 20 74 68 65 20 63 | 68 75 6e 6b 73 20 69 6e |to the c|hunks in|
|000008e0| 20 77 68 69 63 68 20 74 | 68 65 79 20 61 70 70 65 | which t|hey appe|
|000008f0| 61 72 2e 0d 2e 50 50 0d | 49 66 20 61 20 73 74 61 |ar...PP.|If a sta|
|00000900| 72 20 28 5c 66 42 2a 5c | 66 50 29 20 69 73 20 61 |r (\fB*\|fP) is a|
|00000910| 70 70 65 6e 64 65 64 20 | 74 6f 20 74 68 65 20 6e |ppended |to the n|
|00000920| 61 6d 65 20 6f 66 20 61 | 6e 20 6f 75 74 70 75 74 |ame of a|n output|
|00000930| 20 66 69 6c 65 2c 0d 2e | 49 20 6e 6f 77 65 62 0d | file,..|I noweb.|
|00000940| 69 6e 63 6c 75 64 65 73 | 20 6c 69 6e 65 2d 6e 75 |includes| line-nu|
|00000950| 6d 62 65 72 20 69 6e 66 | 6f 72 6d 61 74 69 6f 6e |mber inf|ormation|
|00000960| 20 61 73 20 73 70 65 63 | 69 66 69 65 64 20 62 79 | as spec|ified by|
|00000970| 20 74 68 65 20 5c 66 42 | 2d 4c 5c 66 50 5c 66 49 | the \fB|-L\fP\fI|
|00000980| 66 6f 72 6d 61 74 5c 66 | 50 0d 6f 70 74 69 6f 6e |format\f|P.option|
|00000990| 20 28 6f 72 20 66 6f 72 | 20 43 20 69 66 20 6e 6f | (or for| C if no|
|000009a0| 20 5c 66 42 2d 4c 5c 66 | 50 5c 66 49 66 6f 72 6d | \fB-L\f|P\fIform|
|000009b0| 61 74 5c 66 50 20 6f 70 | 74 69 6f 6e 20 69 73 20 |at\fP op|tion is |
|000009c0| 67 69 76 65 6e 29 2e 0d | 54 68 65 20 6e 61 6d 65 |given)..|The name|
|000009d0| 20 69 74 73 65 6c 66 20 | 6d 61 79 20 6e 6f 74 20 | itself |may not |
|000009e0| 63 6f 6e 74 61 69 6e 20 | 73 68 65 6c 6c 20 6d 65 |contain |shell me|
|000009f0| 74 61 63 68 61 72 61 63 | 74 65 72 73 2e 0d 2e 50 |tacharac|ters...P|
|00000a00| 50 0d 43 6f 64 65 20 6d | 61 79 20 62 65 20 71 75 |P.Code m|ay be qu|
|00000a10| 6f 74 65 64 20 77 69 74 | 68 69 6e 20 64 6f 63 75 |oted wit|hin docu|
|00000a20| 6d 65 6e 74 61 74 69 6f | 6e 0d 63 68 75 6e 6b 73 |mentatio|n.chunks|
|00000a30| 20 62 79 20 70 6c 61 63 | 69 6e 67 20 64 6f 75 62 | by plac|ing doub|
|00000a40| 6c 65 20 73 71 75 61 72 | 65 20 62 72 61 63 6b 65 |le squar|e bracke|
|00000a50| 74 73 0d 28 5c 66 42 5b | 5b 5c 66 49 2e 2e 2e 5c |ts.(\fB[|[\fI...\|
|00000a60| 66 42 5d 5d 5c 66 52 29 | 20 61 72 6f 75 6e 64 20 |fB]]\fR)| around |
|00000a70| 69 74 2e 0d 54 68 65 73 | 65 20 64 6f 75 62 6c 65 |it..Thes|e double|
|00000a80| 20 73 71 75 61 72 65 20 | 62 72 61 63 6b 65 74 73 | square |brackets|
|00000a90| 20 61 72 65 20 75 73 65 | 64 20 74 6f 0d 67 69 76 | are use|d to.giv|
|00000aa0| 65 20 74 68 65 20 63 6f | 64 65 20 73 70 65 63 69 |e the co|de speci|
|00000ab0| 61 6c 20 74 79 70 6f 67 | 72 61 70 68 69 63 20 74 |al typog|raphic t|
|00000ac0| 72 65 61 74 6d 65 6e 74 | 20 69 6e 20 74 68 65 0d |reatment| in the.|
|00000ad0| 2e 49 20 54 65 58 0d 66 | 69 6c 65 2e 0d 49 66 20 |.I TeX.f|ile..If |
|00000ae0| 71 75 6f 74 65 64 20 63 | 6f 64 65 20 65 6e 64 73 |quoted c|ode ends|
|00000af0| 20 77 69 74 68 20 74 68 | 72 65 65 20 6f 72 20 6d | with th|ree or m|
|00000b00| 6f 72 65 20 73 71 75 61 | 72 65 20 62 72 61 63 6b |ore squa|re brack|
|00000b10| 65 74 73 2c 0d 2e 49 20 | 6e 6f 77 65 62 0d 63 68 |ets,..I |noweb.ch|
|00000b20| 6f 6f 73 65 73 20 74 68 | 65 20 72 69 67 68 74 6d |ooses th|e rightm|
|00000b30| 6f 73 74 20 70 61 69 72 | 2c 20 73 6f 20 74 68 61 |ost pair|, so tha|
|00000b40| 74 2c 20 66 6f 72 20 65 | 78 61 6d 70 6c 65 2c 20 |t, for e|xample, |
|00000b50| 5c 66 42 5b 5b 61 5b 69 | 5d 5d 5d 5c 66 52 20 69 |\fB[[a[i|]]]\fR i|
|00000b60| 73 0d 70 61 72 73 65 64 | 20 63 6f 72 72 65 63 74 |s.parsed| correct|
|00000b70| 6c 79 2e 0d 2e 50 50 0d | 49 66 20 64 6f 75 62 6c |ly...PP.|If doubl|
|00000b80| 65 20 6c 65 66 74 20 61 | 6e 64 20 72 69 67 68 74 |e left a|nd right|
|00000b90| 20 61 6e 67 6c 65 20 62 | 72 61 63 6b 65 74 73 20 | angle b|rackets |
|00000ba0| 61 72 65 20 6e 6f 74 20 | 70 61 69 72 65 64 2c 20 |are not |paired, |
|00000bb0| 74 68 65 79 20 61 72 65 | 0d 74 72 65 61 74 65 64 |they are|.treated|
|00000bc0| 20 61 73 20 6c 69 74 65 | 72 61 6c 20 5c 66 42 3c | as lite|ral \fB<|
|00000bd0| 3c 5c 66 50 20 61 6e 64 | 20 5c 66 42 3e 3e 5c 66 |<\fP and| \fB>>\f|
|00000be0| 50 2e 20 20 55 73 65 72 | 73 20 63 61 6e 20 66 6f |P.  User|s can fo|
|00000bf0| 72 63 65 20 61 6e 79 0d | 73 75 63 68 20 62 72 61 |rce any.|such bra|
|00000c00| 63 6b 65 74 73 2c 20 65 | 76 65 6e 20 70 61 69 72 |ckets, e|ven pair|
|00000c10| 65 64 20 62 72 61 63 6b | 65 74 73 2c 20 74 6f 20 |ed brack|ets, to |
|00000c20| 62 65 20 74 72 65 61 74 | 65 64 20 61 73 20 6c 69 |be treat|ed as li|
|00000c30| 74 65 72 61 6c 20 62 79 | 0d 75 73 69 6e 67 20 61 |teral by|.using a|
|00000c40| 20 70 72 65 63 65 64 69 | 6e 67 20 61 74 20 73 69 | precedi|ng at si|
|00000c50| 67 6e 20 28 65 2e 67 2e | 20 5c 66 42 40 3c 3c 5c |gn (e.g.| \fB@<<\|
|00000c60| 66 50 29 2e 0d 2e 50 50 | 0d 41 6e 79 20 6c 69 6e |fP)...PP|.Any lin|
|00000c70| 65 20 62 65 67 69 6e 6e | 69 6e 67 20 77 69 74 68 |e beginn|ing with|
|00000c80| 20 60 5c 66 42 40 20 5c | 66 50 27 20 74 65 72 6d | `\fB@ \|fP' term|
|00000c90| 69 6e 61 74 65 73 20 61 | 20 63 6f 64 65 20 63 68 |inates a| code ch|
|00000ca0| 75 6e 6b 2c 0d 62 75 74 | 20 69 66 20 74 68 65 20 |unk,.but| if the |
|00000cb0| 6c 69 6e 65 20 68 61 73 | 20 74 68 65 20 66 6f 72 |line has| the for|
|00000cc0| 6d 0d 2e 62 72 0d 5c 66 | 42 40 20 25 64 65 66 20 |m..br.\f|B@ %def |
|00000cd0| 5c 66 50 5c 66 49 69 64 | 65 6e 74 69 66 69 65 72 |\fP\fIid|entifier|
|00000ce0| 73 5c 66 50 0d 2e 62 72 | 0d 69 74 20 69 73 20 74 |s\fP..br|.it is t|
|00000cf0| 61 6b 65 6e 20 74 6f 20 | 6d 65 61 6e 20 74 68 61 |aken to |mean tha|
|00000d00| 74 20 74 68 65 20 70 72 | 65 63 65 64 69 6e 67 20 |t the pr|eceding |
|00000d10| 63 68 75 6e 6b 20 64 65 | 66 69 6e 65 73 20 74 68 |chunk de|fines th|
|00000d20| 65 20 69 64 65 6e 74 69 | 66 69 65 72 73 20 6c 69 |e identi|fiers li|
|00000d30| 73 74 65 64 20 0d 69 6e | 20 0d 2e 49 20 69 64 65 |sted .in| ..I ide|
|00000d40| 6e 74 69 66 69 65 72 73 | 2e 0d 54 68 69 73 20 6c |ntifiers|..This l|
|00000d50| 69 73 74 20 63 6f 6e 74 | 61 69 6e 73 20 69 64 65 |ist cont|ains ide|
|00000d60| 6e 74 69 66 69 65 72 73 | 20 73 65 70 61 72 61 74 |ntifiers| separat|
|00000d70| 65 64 20 62 79 20 77 68 | 69 74 65 73 70 61 63 65 |ed by wh|itespace|
|00000d80| 3b 20 0d 61 6e 79 20 73 | 65 71 75 65 6e 63 65 20 |; .any s|equence |
|00000d90| 6f 66 20 6e 6f 6e 77 68 | 69 74 65 20 63 68 61 72 |of nonwh|ite char|
|00000da0| 61 63 74 65 72 73 20 6d | 61 79 20 62 65 20 61 6e |acters m|ay be an|
|00000db0| 20 69 64 65 6e 74 69 66 | 69 65 72 2e 0d 2e 49 20 | identif|ier...I |
|00000dc0| 6e 6f 77 65 62 0d 75 73 | 65 73 20 61 20 73 69 6d |noweb.us|es a sim|
|00000dd0| 70 6c 65 20 68 65 75 72 | 69 73 74 69 63 20 74 6f |ple heur|istic to|
|00000de0| 20 61 76 6f 69 64 20 72 | 65 63 6f 67 6e 69 7a 69 | avoid r|ecognizi|
|00000df0| 6e 67 20 69 64 65 6e 74 | 69 66 69 65 72 73 20 0d |ng ident|ifiers .|
|00000e00| 74 68 61 74 20 61 72 65 | 20 73 75 62 73 74 72 69 |that are| substri|
|00000e10| 6e 67 73 20 6f 66 20 6f | 74 68 65 72 20 69 64 65 |ngs of o|ther ide|
|00000e20| 6e 74 69 66 69 65 72 73 | 2e 0d 2e 53 48 20 4f 50 |ntifiers|...SH OP|
|00000e30| 54 49 4f 4e 53 0d 2e 54 | 50 0d 2e 42 20 5c 2d 74 |TIONS..T|P..B \-t|
|00000e40| 0d 53 75 70 70 72 65 73 | 73 20 67 65 6e 65 72 61 |.Suppres|s genera|
|00000e50| 74 69 6f 6e 20 6f 66 20 | 61 20 0d 2e 49 20 54 65 |tion of |a ..I Te|
|00000e60| 58 0d 66 69 6c 65 2e 0d | 2e 54 50 0d 2e 42 20 5c |X.file..|.TP..B \|
|00000e70| 2d 6f 0d 53 75 70 70 72 | 65 73 73 20 67 65 6e 65 |-o.Suppr|ess gene|
|00000e80| 72 61 74 69 6f 6e 20 6f | 66 20 6f 75 74 70 75 74 |ration o|f output|
|00000e90| 20 66 69 6c 65 73 2e 0d | 2e 54 50 0d 2e 42 20 5c | files..|.TP..B \|
|00000ea0| 2d 4c 5c 66 49 66 6f 72 | 6d 61 74 5c 66 52 0d 55 |-L\fIfor|mat\fR.U|
|00000eb0| 73 65 20 0d 2e 49 20 66 | 6f 72 6d 61 74 0d 74 6f |se ..I f|ormat.to|
|00000ec0| 20 66 6f 72 6d 61 74 20 | 6c 69 6e 65 2d 6e 75 6d | format |line-num|
|00000ed0| 62 65 72 20 69 6e 66 6f | 72 6d 61 74 69 6f 6e 20 |ber info|rmation |
|00000ee0| 66 6f 72 20 73 74 61 72 | 72 65 64 20 6f 75 74 70 |for star|red outp|
|00000ef0| 75 74 20 66 69 6c 65 73 | 2e 0d 28 49 66 20 74 68 |ut files|..(If th|
|00000f00| 65 20 6f 70 74 69 6f 6e | 20 69 73 20 6f 6d 69 74 |e option| is omit|
|00000f10| 74 65 64 2c 20 61 20 66 | 6f 72 6d 61 74 20 73 75 |ted, a f|ormat su|
|00000f20| 69 74 61 62 6c 65 20 66 | 6f 72 20 43 20 69 73 20 |itable f|or C is |
|00000f30| 75 73 65 64 2e 29 0d 2e | 49 20 66 6f 72 6d 61 74 |used.)..|I format|
|00000f40| 0d 69 73 20 61 73 20 64 | 65 66 69 6e 65 64 20 62 |.is as d|efined b|
|00000f50| 79 20 0d 2e 49 20 6e 6f | 74 61 6e 67 6c 65 28 31 |y ..I no|tangle(1|
|00000f60| 29 3b 0d 2e 54 50 0d 2e | 42 20 22 5c 2d 6d 61 72 |);..TP..|B "\-mar|
|00000f70| 6b 75 70 20 5c 66 49 70 | 61 72 73 65 72 5c 66 50 |kup \fIp|arser\fP|
|00000f80| 22 0d 55 73 65 20 0d 2e | 49 20 70 61 72 73 65 72 |".Use ..|I parser|
|00000f90| 0d 74 6f 20 70 61 72 73 | 65 20 74 68 65 20 69 6e |.to pars|e the in|
|00000fa0| 70 75 74 20 66 69 6c 65 | 2e 0d 45 6e 61 62 6c 65 |put file|..Enable|
|00000fb0| 73 20 75 73 65 20 6f 66 | 20 6e 6f 77 65 62 20 74 |s use of| noweb t|
|00000fc0| 6f 6f 6c 73 20 6f 6e 20 | 66 69 6c 65 73 20 69 6e |ools on |files in|
|00000fd0| 20 6f 74 68 65 72 20 66 | 6f 72 6d 61 74 73 3b 0d | other f|ormats;.|
|00000fe0| 66 6f 72 20 65 78 61 6d | 70 6c 65 2c 20 74 68 65 |for exam|ple, the|
|00000ff0| 20 0d 2e 42 20 6e 75 6d | 61 72 6b 75 70 0d 70 61 | ..B num|arkup.pa|
|00001000| 72 73 65 72 20 75 6e 64 | 65 72 73 74 61 6e 64 73 |rser und|erstands|
|00001010| 0d 2e 49 20 6e 75 77 65 | 62 28 31 29 0d 66 6f 72 |..I nuwe|b(1).for|
|00001020| 6d 61 74 2e 0d 53 65 65 | 20 0d 2e 49 20 6e 6f 77 |mat..See| ..I now|
|00001030| 65 62 66 69 6c 74 65 72 | 73 28 31 29 0d 66 6f 72 |ebfilter|s(1).for|
|00001040| 20 6d 6f 72 65 20 69 6e | 66 6f 72 6d 61 74 69 6f | more in|formatio|
|00001050| 6e 2e 0d 46 6f 72 20 65 | 78 70 65 72 74 73 20 6f |n..For e|xperts o|
|00001060| 6e 6c 79 2e 0d 2e 53 48 | 20 42 55 47 53 0d 2e 50 |nly...SH| BUGS..P|
|00001070| 50 0d 49 67 6e 6f 72 69 | 6e 67 20 75 6e 75 73 65 |P.Ignori|ng unuse|
|00001080| 64 20 63 68 75 6e 6b 73 | 20 77 68 6f 73 65 20 6e |d chunks| whose n|
|00001090| 61 6d 65 73 20 63 6f 6e | 74 61 69 6e 20 73 70 61 |ames con|tain spa|
|000010a0| 63 65 73 0d 73 6f 6d 65 | 74 69 6d 65 73 20 63 61 |ces.some|times ca|
|000010b0| 75 73 65 73 20 70 72 6f | 62 6c 65 6d 73 2c 20 65 |uses pro|blems, e|
|000010c0| 73 70 65 63 69 61 6c 6c | 79 20 69 6e 20 74 68 65 |speciall|y in the|
|000010d0| 20 63 61 73 65 20 77 68 | 65 6e 20 61 20 63 68 75 | case wh|en a chu|
|000010e0| 6e 6b 20 68 61 73 0d 6d | 75 6c 74 69 70 6c 65 20 |nk has.m|ultiple |
|000010f0| 64 65 66 69 6e 69 74 69 | 6f 6e 73 20 61 6e 64 20 |definiti|ons and |
|00001100| 6f 6e 65 20 69 73 20 6d | 69 73 73 70 65 6c 6c 65 |one is m|isspelle|
|00001110| 64 3b 0d 74 68 65 20 6d | 69 73 73 70 65 6c 6c 65 |d;.the m|isspelle|
|00001120| 64 20 64 65 66 69 6e 69 | 74 69 6f 6e 20 77 69 6c |d defini|tion wil|
|00001130| 6c 20 62 65 20 73 69 6c | 65 6e 74 6c 79 20 69 67 |l be sil|ently ig|
|00001140| 6e 6f 72 65 64 2e 0d 2e | 49 20 6e 6f 72 6f 6f 74 |nored...|I noroot|
|00001150| 73 28 31 29 0d 63 61 6e | 20 62 65 20 75 73 65 64 |s(1).can| be used|
|00001160| 20 61 73 20 61 20 73 61 | 6e 69 74 79 20 63 68 65 | as a sa|nity che|
|00001170| 63 6b 65 72 20 74 6f 20 | 63 61 74 63 68 20 74 68 |cker to |catch th|
|00001180| 69 73 20 73 6f 72 74 20 | 6f 66 20 6d 69 73 74 61 |is sort |of mista|
|00001190| 6b 65 2e 0d 2e 50 50 0d | 2e 49 20 6e 6f 77 65 62 |ke...PP.|.I noweb|
|000011a0| 0d 72 65 71 75 69 72 65 | 73 20 74 68 65 20 6e 65 |.require|s the ne|
|000011b0| 77 20 76 65 72 73 69 6f | 6e 20 6f 66 0d 2e 49 20 |w versio|n of..I |
|000011c0| 61 77 6b 2c 0d 61 73 73 | 75 6d 65 64 20 74 6f 20 |awk,.ass|umed to |
|000011d0| 62 65 20 63 61 6c 6c 65 | 64 0d 2e 49 20 6e 61 77 |be calle|d..I naw|
|000011e0| 6b 2e 0d 44 45 43 0d 2e | 49 20 6e 61 77 6b 0d 68 |k..DEC..|I nawk.h|
|000011f0| 61 73 20 61 20 62 75 67 | 20 69 6e 20 74 68 61 74 |as a bug| in that|
|00001200| 20 74 68 61 74 20 63 61 | 75 73 65 73 20 70 72 6f | that ca|uses pro|
|00001210| 62 6c 65 6d 73 20 77 69 | 74 68 20 62 72 61 63 65 |blems wi|th brace|
|00001220| 73 20 69 6e 0d 2e 49 20 | 54 65 58 0d 6f 75 74 70 |s in..I |TeX.outp|
|00001230| 75 74 2e 0d 47 4e 55 20 | 0d 2e 49 20 67 61 77 6b |ut..GNU |..I gawk|
|00001240| 0d 69 73 20 72 65 70 6f | 72 74 65 64 20 74 6f 20 |.is repo|rted to |
|00001250| 77 6f 72 6b 2e 0d 2e 50 | 50 0d 54 68 65 20 64 65 |work...P|P.The de|
|00001260| 66 61 75 6c 74 0d 2e 49 | 20 4c 61 54 65 58 0d 70 |fault..I| LaTeX.p|
|00001270| 61 67 65 73 74 79 6c 65 | 73 20 64 6f 6e 27 74 20 |agestyle|s don't |
|00001280| 73 65 74 20 74 68 65 20 | 77 69 64 74 68 20 6f 66 |set the |width of|
|00001290| 20 74 68 65 20 62 6f 78 | 65 73 20 63 6f 6e 74 61 | the box|es conta|
|000012a0| 69 6e 69 6e 67 20 68 65 | 61 64 65 72 73 20 61 6e |ining he|aders an|
|000012b0| 64 20 66 6f 6f 74 65 72 | 73 2e 0d 53 69 6e 63 65 |d footer|s..Since|
|000012c0| 20 0d 2e 49 20 6e 6f 77 | 65 62 0d 63 6f 64 65 20 | ..I now|eb.code |
|000012d0| 70 61 72 61 67 72 61 70 | 68 73 20 61 72 65 20 65 |paragrap|hs are e|
|000012e0| 78 74 72 61 20 77 69 64 | 65 2c 20 74 68 69 73 20 |xtra wid|e, this |
|000012f0| 0d 2e 49 20 4c 61 54 65 | 58 0d 62 75 67 20 73 6f |..I LaTe|X.bug so|
|00001300| 6d 65 74 69 6d 65 73 20 | 72 65 73 75 6c 74 73 20 |metimes |results |
|00001310| 69 6e 20 65 78 74 72 61 | 2d 77 69 64 65 20 68 65 |in extra|-wide he|
|00001320| 61 64 65 72 73 20 61 6e | 64 20 66 6f 6f 74 65 72 |aders an|d footer|
|00001330| 73 2e 0d 54 68 65 20 72 | 65 6d 65 64 79 20 69 73 |s..The r|emedy is|
|00001340| 20 74 6f 20 72 65 64 65 | 66 69 6e 65 20 74 68 65 | to rede|fine the|
|00001350| 20 72 65 6c 65 76 61 6e | 74 20 0d 2e 42 20 70 73 | relevan|t ..B ps|
|00001360| 40 2a 0d 63 6f 6d 6d 61 | 6e 64 73 3b 0d 2e 42 20 |@*.comma|nds;..B |
|00001370| 70 73 40 6e 6f 77 65 62 | 0d 69 6e 20 0d 2e 42 20 |ps@noweb|.in ..B |
|00001380| 6e 6f 77 65 62 2e 73 74 | 79 0d 63 61 6e 20 62 65 |noweb.st|y.can be|
|00001390| 20 75 73 65 64 20 61 73 | 20 61 6e 20 65 78 61 6d | used as| an exam|
|000013a0| 70 6c 65 2e 0d 2e 53 48 | 20 53 45 45 20 41 4c 53 |ple...SH| SEE ALS|
|000013b0| 4f 0d 2e 50 50 0d 2e 49 | 20 22 6e 6f 74 61 6e 67 |O..PP..I| "notang|
|000013c0| 6c 65 28 31 29 2c 20 6e | 6f 77 65 61 76 65 28 31 |le(1), n|oweave(1|
|000013d0| 29 2c 20 6e 6f 72 6f 6f | 74 73 28 31 29 2c 20 6e |), noroo|ts(1), n|
|000013e0| 6f 75 6e 74 61 6e 67 6c | 65 28 31 29 2c 20 6e 6f |ountangl|e(1), no|
|000013f0| 77 65 62 73 74 79 6c 65 | 28 31 29 2c 22 0d 2e 49 |webstyle|(1),"..I|
|00001400| 20 22 6e 6f 77 65 62 66 | 69 6c 74 65 72 73 28 31 | "nowebf|ilters(1|
|00001410| 29 2c 20 6e 75 77 65 62 | 32 6e 6f 77 65 62 28 31 |), nuweb|2noweb(1|
|00001420| 29 22 0d 2e 62 72 0d 4e | 6f 72 6d 61 6e 20 52 61 |)"..br.N|orman Ra|
|00001430| 6d 73 65 79 2c 0d 2e 49 | 20 22 4c 69 74 65 72 61 |msey,..I| "Litera|
|00001440| 74 65 20 70 72 6f 67 72 | 61 6d 6d 69 6e 67 20 73 |te progr|amming s|
|00001450| 69 6d 70 6c 69 66 69 65 | 64 2c 20 49 45 45 45 20 |implifie|d, IEEE |
|00001460| 53 6f 66 74 77 61 72 65 | 22 0d 31 31 28 35 29 3a |Software|".11(5):|
|00001470| 39 37 2d 31 30 35 2c 20 | 53 65 70 74 65 6d 62 65 |97-105, |Septembe|
|00001480| 72 20 31 39 39 34 2e 0d | 2e 53 48 20 41 55 54 48 |r 1994..|.SH AUTH|
|00001490| 4f 52 0d 4e 6f 72 6d 61 | 6e 20 52 61 6d 73 65 79 |OR.Norma|n Ramsey|
|000014a0| 2c 20 42 65 6c 6c 63 6f | 72 65 2e 0d 49 6e 74 65 |, Bellco|re..Inte|
|000014b0| 72 6e 65 74 20 61 64 64 | 72 65 73 73 20 5c 66 42 |rnet add|ress \fB|
|000014c0| 6e 6f 72 6d 61 6e 40 62 | 65 6c 6c 63 6f 72 65 2e |norman@b|ellcore.|
|000014d0| 63 6f 6d 5c 66 50 2e 0d | 2e 62 72 0d 4e 6f 77 65 |com\fP..|.br.Nowe|
|000014e0| 62 20 68 6f 6d 65 20 70 | 61 67 65 20 61 74 20 5c |b home p|age at \|
|000014f0| 66 42 66 74 70 3a 2f 2f | 62 65 6c 6c 63 6f 72 65 |fBftp://|bellcore|
|00001500| 2e 63 6f 6d 2f 70 75 62 | 2f 6e 6f 72 6d 61 6e 2f |.com/pub|/norman/|
|00001510| 77 77 77 2f 6e 6f 77 65 | 62 2f 69 6e 74 72 6f 2e |www/nowe|b/intro.|
|00001520| 68 74 6d 6c 5c 66 50 2e | 0d                      |html\fP.|.       |
+--------+-------------------------+-------------------------+--------+--------+